Entrée de Registre Extension Repeater

Exporter une ligne pour chaque valeur d’un tableau de valeurs lors de l’exportation des données d’extension.1

Description

Un norme est défini dans EMu par la création et la maintenance de deux types d’enregistrements dans le module Normes :

Type d’enregistrement	Détails
Définition de terme	Un enregistrement de Définition de terme associe un ou plusieurs champs EMu à un terme dans un norme. Plusieurs enregistrements de Définition de terme sont créés pour chaque norme.
Norme	Un enregistrement Norme regroupe les Définitions de terme dans un format d’exportation unique conforme à un norme particulier.

La fonction Exports planifiés d’EMu permet d’exporter des données EMu conformes à ce norme. Alors qu’une exportation typique d’EMu permet d’exporter des données à partir d’une ou plusieurs colonnes, les données sont exportées telles quelles ; elles ne peuvent pas être manipulées, formatées ou combinées avec d’autres valeurs lors de leur exportation. Lors de l’exportation vers un norme, il est possible de combiner, de manipuler et de formater les valeurs de deux ou plusieurs colonnes pour produire une seule valeur d’exportation.

Lors de la définition d’un enregistrement Norme qui regroupe les Définitions de terme pour un norme, Dublin Core par exemple, tous les enregistrements de Définition de terme doivent utiliser le même module (par exemple, ecatalogue pour les données sur les objets). S’il est nécessaire d’inclure des enregistrements d’autres modules dans la sortie des données, définissez un autre enregistrement Normes, Audubon Core par exemple (en regroupant les Définitions de terme pertinentes d’un autre module, par exemple les données multimédias d'emultimedia) et utilisez le processus d’Extension pour combiner les deux (ou plusieurs) normes lors de la définition de l’exportation.

Il n’est possible de combiner l’exportation de deux normes que si une entrée du Registre Standard Extension définit la relation entre les deux normes.

Le but de l'entrée du Registre Extension Repeater

Lors de l'exportation vers une Norme et une extension, si l'un des champs de l'extension est une table de valeurs, les valeurs de cette table sont exportées sous la forme d'une seule valeur séparé par des barres verticales. Avec l'Entrée de Registre Extension Repeater, chaque valeur du tableau est exportée indépendamment des autres valeurs.

Note: L'entrée du Registre Extension Repeater est disponible à partir d'EMu 9.1.

Un exemple clarifiera ce que l’on entend par là.

Nous voulons exporter les données d’objets (d’ecatalogue) vers le standard Darwin Core avec une extension du standard Audubon Core afin d’inclure les données multimédias (d’emultimedia).

Les données sont exportées vers le standard Darwin Core à partir de cinq champs. Voici les définitions de ces termes :

dwc:DateCreated
dwc:DateCreatedUTC
dwc:Identifier
dwc:Title
dwc:Material

En plus de ces données, deux champs sont exportés à partir de l’extension. Voici les définitions de ces termes :

aud:Title
aud:ObjectIdentfier

aud:ObjectIdentfier est un tableau de valeurs.

Lorsque le tableau comprend plusieurs valeurs, les valeurs sont exportées ensemble, généralement séparées par une barre verticale. Dans cet exemple, aud :ObjectIdentfier contient deux valeurs et le XML exporté est le suivant :

<!-- Row 1 -->

<tuple>

<atom name="dwc:DateCreated">2014-06-25</atom>

<atom name="dwc:DateCreatedUTC">2014-06-25T02:31:04.000+01:00</atom>

<atom name="dwc:Identifier">2d5fcbee-9f26-4e0e-ab07-4259fdeb7d52</atom>

<atom name="dwc:Title">[Painting] Man standing in field</atom>

<atom name="dwc:Material">Canvas|Oil Paint</atom>

<table>

<!-- Row 1 -->

<tuple>

<atom name="aud:Title">Man standing in field</atom>

         <atom name="aud:ObjectIdentfier">2d5fcbee-9f26-4e0e-ab07-4259fdeb7d52|7c8f5f4a-63f1-11ee-8c99-0242ac120002</atom>

</tuple>

</table>

</tuple>

With the Extension Repeater Registry entry, the values in the table are exported separately. A row is added to the export file for each pair of fields in the extension:

<tuple>

<atom name="dwc:DateCreated">2014-06-25</atom>

<atom name="dwc:DateCreatedUTC">2014-06-25T02:31:04.000+01:00</atom>

<atom name="dwc:Identifier">2d5fcbee-9f26-4e0e-ab07-4259fdeb7d52</atom>

<atom name="dwc:Title">[Painting] Man standing in field</atom>

<atom name="dwc:Material">Canvas|Oil Paint</atom>

<table>

   <!-- Row 1 -->

<tuple>

         <atom name="aud:Title">Man standing in field</atom>

         <atom name="aud:ObjectIdentfier">2d5fcbee-9f26-4e0e-ab07-4259fdeb7d52</atom>

</tuple>

   <!-- Row 2 -->

<tuple>

         <atom name="aud:Title">Man standing in field</atom>

         <atom name="aud:ObjectIdentfier">7c8f5f4a-63f1-11ee-8c99-0242ac120002</atom>

</tuple>

</table>

</tuple>

Notez la réplication de aud:Title.

Utilisation

Cette Entrée de Registre est attribuée aux utilisateurs et aux groupes :

Clé	Utilisateur	Groupe	Groupe
Clé 1	`User`	`Group`	`Group`
Clé 2	utilisateur	groupe	`Default`
Clé 3	`Table`
Clé 4	`estandards`
Clé 5	`Extension Repeater`
Clé 6	Nom du norme
Clé 7	Nom d’extension
Valeur	Terme Core;Terme d'Extension

Dans un format délimité par des | (barres verticales)

`User`	utilisateur	`Table`	`estandards`	`Extension Repeater`	Nom du norme	Nom d’extension	Terme Core;Terme d'Extension
`Group`	groupe	`Table`	`estandards`	`Extension Repeater`	Nom du norme	Nom d’extension	Terme Core;Terme d'Extension
`Group`	`Default`	`Table`	`estandards`	`Extension Repeater`	Nom du norme	Nom d’extension	Terme Core;Terme d'Extension

où :

Nom du norme

désigne le nom d’un norme enregistré (Type d’enregistrement = Norme) dans le module Normes. Le nom du norme est enregistré sous Nom : (Nom de l'extrait).

Nom d’extension

désigne le nom d’un autre norme enregistré (Type d’enregistrement = Standard) dans le module Standards. Le nom du norme est enregistré sous Nom : (Nom de l'extrait).

Terme Core;Terme d'Extension

où :

Terme Core est un champ de Nom de la norme qui identifie de manière unique un enregistrement exporté (par exemple, Numéro d’objet).
Terme d’Extension est un champ de Nom d’extension qui correspond à un tableau de valeurs.

Lorsque le Terme Core correspond à Terme d’Extension (la table des valeurs), une ligne est générée dans le fichier d’export XML.

Explication

Dans le module Catalogue :

L’objet A (ID1) est relié à deux enregistrements du module Multimédia, l’Image 1 et l’Image 2
L’objet B (ID2) est également relié à ces deux enregistrements du module Multimédia, l’Image 1 et l’Image 2.

Un tableau de valeurs figurant dans les enregistrements du module Multimédia répertorie les objets auxquels les images sont associées :

L’image 1 répertorie deux enregistrements du Catalogue :
- ID1
- ID2
L’image 2 présente deux enregistrements du Catalogue :
- ID1
- ID2

Lorsque Aududon est une extension et que l'on exporte les données de ce tableau de valeurs, quatre valeurs seraient exportées pour l'objet A, car le tableau de valeurs de l'image 1 contient deux enregistrements et celui de l'image 2 en contient également deux :

Image 1 de l’objet A (ID1)
Image 2 de l’objet A (ID1)
Image 1 de l’objet B (ID2)
Image 2 de l’objet B (ID2)

C’est pourquoi nous associons Terme Core avec Terme d’Extension.

La correspondance de Terme Core (l’ID de l’objet dans cet exemple) dans Terme d’Extension (la table des valeurs) garantit que seules les données associées à un objet spécifique sont exportées. En faisant correspondre ID1 dans la table des valeurs, le résultat pour l’objet A est :

Image 1 de l’objet A (ID1)
Image 2 de l’objet A (ID1)

et la sortie obtenue pour l’objet B est :

Image 1 de l’objet B (ID2)
Image 2 de l’objet B (ID2)

Exemple

Lors de l'exportation de données à partir de l'extension Audubon Core, une ligne distincte est exportée pour chaque ac:Id associé à un dwc:Id:

Clé	Paramètre
Clé 1	Groupe
Clé 2	Default
Clé 3	Table
Clé 4	estandards
Clé 5	`Extension Repeater`
Clé 6	Darwin Core
Clé 7	Audubon Core
Valeur	dwc:Id;ac:Id

Rubriques connexes